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I. INTRODUCTION 


MODOS is essentially compatible with MDOS. The major 
changes have been to eliminate all of the EXbug dependencies 
from it and to provide an automatic start up capability. 
These changes allow MODOS to run without the Debug Module in 
the EXORciser. Other changes to MDOS have been made so that 
the OEM Manufacturer can customize the system to his hardware 
configuration. The address of the console ACIA can easily be 
changed. If, for example, the Manufacturer’s console terminal 
runs off a PIA instead of an ACIA, he may substitute his own 
I/Q routines for the ones provided with the system. His 
routines may reside in ROM or be loaded into RAM by MODOS 
during initialization. The user. may provide interrupt 
handlers for NMI, SWI, and IRQ interrupts. Like the I/0 
routines, these handlers may reside in ROM or be loaded in by 
MODOS. In addition to providing his own driver for the 
console (keyboard/printer, punch, and reader), the user may 
substitute his own line printer driver. 


MODOS can be initialized when power is applied to the 
system. The OEM disk PROM initiates the MODOS' bootload 
process. If an error occurs during the load, the error status 
is printed on the console and the system hangs up. If the 
output character and console initialization routines in the 
PROM are not compatible with the hardware configuration, the 
OEM Manufacturer must modify the routines in PROM to satisfy 
his needs. These routines are in addition to the resident 
console I/7(0 routines. The user can cause his I/0 routines 
and/or interrupt handlers to be loaded in by MODOS by putting 
them in a file called MDOSUDRV.SY. If he does not do this, 
these routines must be in ROM. 


When MODOS has completed initialization, it does one of 
two things depending on how the _ user has configured the 
system. Either a user selected sign-on message is printed, 
followed by a prompt, or a user selected command is loaded 
and control passed to it. This user initialization routine 
may be used to perform any special processing required for 
his system. 


Although MODOS is not an_= end-customer development 
system, the need for the OEM Manufacturer to test his 
programs is recognized. This is accomplished by placing the 
MODOS software in an EXORciser/EXORdisk system. The user must 
change the jump vectors for all of the PROM entry points 
(disk and line printer drivers) and insure that his OEM 
memory map is compatible with the map for EXORdisk II or III 
MDOS. After this has been done, the Manufacturer can use 
EXbug to set breakpoints, display and change memory, etc. 


The MODOS system as configured and sent to the customer 
can be run in an EXORciser/EXORdisk environment using EXbug. 
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II. USER CHANGEABLE VARIABLES 


This section contains a description of each MODOS 
variable that the OEM Manufacturer can modify to tailor the 
system to his hardware requirements. Also included is the 
absolute address of each variable so that the user can patch 
the file MDOS.SY. For jump vectors, the address given is to 
the jump address, not the jump-.instruction. All locations and 
values are in hexadecimal unless otherwise stated. 


NAME LOCATION(S) DESCRIPTION 


SWISSV 116-117 If the system has an SWI handler that 
should be envoked after MODOS have been 
overlaid by a command (using the LOAD$VG 
command), SWI$SV must contain the address 
of this routine. If SWISSV has not been 
initialized (i.e., SWISSV = 0), MODOS 
initializes the value to cause a jump to 
self in case an SWI occurs after MODOS 
has been overlaid. If EXbug is present 
(see XBUGFS description), MODOS- stores 
MAID%s SWI handler address at SWISSV, 
regardless of its initialized value. This 
means that the user’s SWI handler cannot 
get control if MODOS is overlaid and 
EXbug is present. The SWI handler must 
reside in ROM or be included in the file 


MDOSUDRY.SY. 
SWISUV 118-119 If the system has user function calls 
(reference MDOS manual, system 


functions), SWISUV must contain the 
address of the user function call 
handler. If SWISUV has not been 
initialized (i.e. SWISUV = 0), MODOS sets 
up SWISUV to cause an RTI to be executed 
if a user function call is encountered. 
The user function call handler must 
reside in ROM or be. included in the file 
MDOSUDRV.SY. 


IRQSUV 11A-11B If the user wishes to have an IRQ handler 
in the system while MODOS is’ resident, 
IRQ$SUV must contain the address of the 
user’s IRQ handler. If IRQSUV has not 
been initialized, MODOS sets up IRQSUV to 
cause an RTI to be executed if an IRQ is 
generated while: MODOS is resident. The 
IRQ handler must reside in ROM or be 
included in the file MDOSUDRV.SY. 


IRQ$SV_ 11C-11D Similar to SWISSV except for IRQ handler. 
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NMISSV 


CNACI$ 


SBITS$ 


1A0-1 Al 
1A2—1A3 
1A4 


Similar to SWIS$SV except for NMI handler. 
The user must beware that a disk timeout 
causes an NMI. Thus, if the user is 
allowing NMI“%s to occur after MQDOS has 
been overlaid, none can _ occur while a 
disk transfer is in progress as it will 
be treated as a disk timeout. For this 
reason, the system does not support user 
NMI“s while MODOS is resident. 


CNACI$ contains the address of the 
console ACIA. It is initialized to S$FCF4 
to run with EXbug but can be changed by 
the OEM Manufacturer to suit his hardware 
requirements. 


SBIT$ contains the stop bits required for 
the console, as well as information about 
parity, clock divide ratio, and control 
of interrupts. The fields are? 


1. Clock divide ratio bits (2 right most 
bits) 


1 O FUNCTION 
Oo .6O /\ 

Oo | 416 

1 O 764 

1 ood 


Master Reset 


2. Word length, parity, and number of 
stop bits 


4 3 2 FUNCTION 


0 O O 7 bitsteven parity+2 stop bits 

0 0 1 7 bitstodd parity+2 stop bits 

(on ee) 7 bitsteven parity+l stop bit 

Oo | 1 7 bitstodd parity+l stop bit 

1 0 O 8 bitst+2 stop bits 

io 4 8 bits+l stop bit 

1: i. @ 8 bitsteven parity+l stop bit 

a: of Ff 8 bitstodd parity+l stop bit 

3. Transmitter control bits 

6 5 FUNCTION 

0 0 ~RTS=low, transmitting 
interrupt disabled 

Oo | ~RTS=low, transmitter interrupt 
enabled 

1 O ~RTS=high, transmitting 
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XPEEDS$ 


CHARNS 


CRNLS$ 


XBUGF$ 


1.A5 


1A6 


1A7 


1A8 


interrupt disabled 

1 4 ~RTS=low, transmits a break 
level on the transmit data 
output’ transmitting interrupt 
disabled 


4. Receive interrupt enable bit--bit 7 


The following interrupts will be enabled 
by having bit 7 set: receive data 
register full, overrun, or a low to high 
transition on the ~DCD signal line. 


SBIT$ is initialized to $55 which sets 
the proper number of stop bits for a 
console speed of 30 characters per second 
or more. 


XPEED$ indicates console speed and is 
initially set for 30 cps. Valid values 
ares 


CPS XPEEDS$ 
10 0) 

30 | 

120 EF 

240 FF 


CHARNS indicates the number of null pads 
to follow every character but a carriage 
return. It is initially set for 30 cps. 
Valid values are? 


CPS CHARNS 
10 ¢) 
30 ) 
120 3 
240 7 


CRNL$ indicates the number of null pads 
to follow ae carriage return and is 
initialized for 30 cps. Valid values are? 


CPS CRNLS$ 
10 @) 

30 4 

120 17 
240 2F 


XBUGF$ indicates whether or not EXbug is 
in the system. It is initialized to one 
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AUTOIS 


AUTOLS$ 


LPPIAS$ 


1A9 
1 AA~1 BD 
1 BE—1 BF 


to indicate that EXbug is present. This 
allows the OEM Manufacturer to test his 
software using an EXORciser/EXORdisk 
system. (Reference Section III.) When 
running without an EXORciser/EXORdi sk 
system, this field should be set to zero. 


AUTOI$ is a flag that indicates whether 
or not MODOS” should automatically load 
and pass control to ae user’ selected 
program upon completion of MODOS 
initialization. AUTOI$ is initialized to 
zero which indicates that no program will 
be loaded. However, with AUTOIS = O, 
MODOS prints a user specified sign-on 
message at campletion of initialization 
(reference AUTOLS$). If AUTOIS$ is 
non-zero, MODOS will load and pass 
control to a user specified program 
(reference AUTOLS). 


This is a 20 byte buffer used in 
conjuction with AUTOIS$. If AUTOIS is set 
to zero, AUTOLS$ contains a sign-on 
message assigned by the user. The ASCII 
message must be terminated by an EOT (04) 
and cannot exceed 20 characters, 
including the EOQT. If AUTOI$ is non-zero, 
AUTOL$ contains the name of a file that 
should be loaded and executed 
automatically. The file name and any 
parameters to the program should appear 
in AUTOL$ exactly as they would be 
entered on the command line by the’ user. 
The length of the command cannot exceed 
20 characters. Unused trailing 
characters should be spaces. MODOS will 
insert a carriage return in the _ buffer 
when the message is moved to MODOS%s 
internal command buffer. AUTOLS$ is 
initially set to an EOT followed by 19 
spaces. Thus, no sign-on message is 
printed. 


LPPIA$ contains the address of the line 
printer PIA. It is initialized to S$ECIO 
to run with EXbug but can be changed by 
the OEM manufacturer to suit his hardware 
requirements. 


The following describes the jump vectors for the console 
I/O routines. Most likely, the OEM Manufacturer would have to 


substitute 


his own routines for all of the resident routines 
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if his console 


included 
character to the the line printer. 


is the 


different type 


must 


I/0 


Jump 


of printer is being used. 
be in ROM or in the file MDOSUDRV.SY. Each of his 


routines is 


not interfaced through an ACIA. Also 
vector to the routine to output a 
It can be modified if a 
The routines must 
routines 


remain call compatible with the existing routines, both 
in terms of entry and 
resident 


exit conditions. A 


included 


listing of the 
in Appendix B so as to 


document the calling sequences and functions. 


NAME 
INCH WP 
QUTCH 


PCRLF 


PDATA 


OCHAR 


INTCN 
BRKCK 
LIST 


The 
by the unified I/0 package in MODOS. For each driver, 


LOCATIONS 
1C1l-1C2 
1C4-1C5 
1C7-1C8 
1CA-1CB 
}CD-1CE 
1DO-1DI1 
1D3-1D4 
241-242 
following 


DESCRIPTION 
Inputs one character with no parity. 


Qutputs one character with required speed 
fill. 


Prints carriage 
null on console. 


return, line feed, and 


Prints carriage return, line feed, and 
data string terminated by EOT on console. 


Outputs one character with no null pading 
to console. 


Initializes console. 
Checks to see if break key was pressed. 


Print contents of A-accumulator o0n 
printer. 


line 


are jump vectors for device drivers used 
there 


are five jump vectors-one-for each of the entry points to the 


driver. 


Calling sequence requirements are 


described in the 


MDOS manual under Device Drivers. 


LOCATIONS 
1D6-1D7 
ID9-1DA 
1DC-1DD 
1DF-1E0 
1E2-1E3 
1E5-1E6 


ENTRY POINT 


Console 
Console 
Console 
Console 
Console 


Console 


keyboard/printer on. 
keyboard/printer off. 
keyboard/printer initialization. 
keyboard/printer termination. 
keyboard/printer input/output. 


reader on. 
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JE8-1E9 Console reader off. 

FEB-1 EC Console reader initialization. 
LEE-TEF Console reader termination. 
IFI-1F2 Console reader input/output. 
1F4-1F5 Console punch on. 

iF 7=1F8 Console punch off. 

1FA-1FB Console punch initializtion. 
|} FD-1FE Console punch termination. 
200-201 Console punch input/output. 
203-204 Line printer on. 

206-207 Line printer off. 

209=-20A Line printer initialization. 
20C-20D Line printer termination. 
20F-210 Line printer output. 


If a user-device driver is substituted for a resident 
device driver, it may also necessary for the OEM Manufacturer 
to modify the Controller Descriptor Block (CDB) for that 
device. The CDB format is described in the MDOS manual. The 
address of the start of each CDB (i.e. the CDBIOC address) is 
contained in the table below: 


DEVICE CDB ADDRESS 


Console keyboard/printer 712 


Console reader 6F8 
Console punch 705 
Line printer 6DE 


The following are jump vectors for the entry points in 
the disk and line printer drivers that reside in ROM. 
Normally, these jump vectors are altered by running the chain 
files OEMEX.CF and OEMCVT.CF. However, if the OEM 
Manufacturer modifies the relative starting addresses of the 
ROM routines, he must also change the jump vectors. 
(Reference Section III.) 
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NAME LOCATIONS DESCRIPTION 

DRVTYs$ 211-212 Not an entry point. Drive type. 
OSLOAD 214-215 Initialize disk’s PIA and SSDA. 
FDINIT 217-218 Initialize disk’s PIA and SSDA. 
CHKERR 21A-21B Check and print error. 

PRNTER 21D-21E Print error from FDSTAT. 

READSC 220-22 1 Read sector(s). 

READPS 223-224 Read partial sector. 

RDCRC 226-227 Read and check for CRC. 

RWTEST 229-22A Read/write test. 

RESTOR 22C-22D Move head to track 0. 

SEEK 22F-230 Position head to track of “STRSCTY 
NRTEST 232-233 Write test. 

NRDDAM 220236 Write deleted data mar. 

WRVERF 238-239 Write and verify CRC. 

WRITSC 23B-23C Write sector(s). 

LPINIT 23E-23F Initialize printer PIA. 


Two examples are included here to demonstrate how to use 
PATCH to change the variables. The first example shows how to 
change the console ACIA address and change the console _ speed 
to 120 characters per second. The second shows how to specify 
a program to be loaded and executed immediately following 
MODOS initialization. In both cases, the MODOS diskette is in 
drive | of an EXORciser/EXORdisk MDOS system. 
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PATCH MDOS.SY?1 


0100 30 

>00 BE SURE TO SET OFFSET TO 0 
>1A2/E4,08 CHANGE ACIA ADDRESS 
>1A5/FF,3,17 CHANGE SPEED TO 120 

>Q 

PATCH MDOS.SY21 PATCH TO EXECUTE ’DIR?% 
0100 30 

>00 CHANGE OFFSET 

>1A9ZI1 SET AUTOIS=1 

>1AA/#DIR" INSERT COMMAND IN AUTOLS 


>Q 


= 


The patch below can be used to elimate the "39" that 
appears on the console during initialization. The "3:9" is 
caused by the INICN routine processing during initialization 
which causes a TI type printer to be turned on. If the 
console is a CRT, the "2:9" can be omitted by eliminating the 
call to INTCN. 


PATCH MDOS.SY#1 


0100 30 
>09 CHANGE OFFSET 
>1CFCRTS) ALTER INTCN JMP VECTOR 


>Q 
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III. DEVELOPING PROGRAMS FOR MODOS 


Programs intended for use with MODOS may be developed on 
the standard EXORciser/EXORdisk system using MDOS. The MDOS 
editor and assembler are used to develop MODOS compatiable 
programs. The programs may be debugged using the EXbug 
version of MODOS. 


Tne EXbug version of MODOS is a configuration of MODOS 
designed to permit the user to debug with the aid of EXbug. 
As shown as Appendix A-I|, this configuration has a memory map 
identical to that of the EXORciser/EXORdisk development 
system. However, the MODOS software has been modified to use 
the standard MDOS PROM. MODOS as supplied to the user. on 
diskette is configured to this EXbug version. 


In order to debug a program using the EXbug version, the 
following steps must be followed? 


1) Assemble the MODOS program using MDOS. If the MODOS 
program references the system equate file, EQU.SA, the 
MODOS version as supplied on the MODOS diskette must be 
used when assembling the_ program. The MDOS and MODOS 
versions of EQU.SA are not identical. 

If RLOAD is used, the commands shown below must be tsed: 


BASE=$nnnn 
STRB=$ bb 


where nnnn is a hexadecimal number larger than $2I1FF and 
bb if a hexadecimal number between $40 and $FF. 


2) Copy the program object file to the MODOS diskette. 
3) Hit the “RESTART’ button on the EXORciser. 


4) Place the MODOS diskette in drive 0 and reboot the system 
using the EXbug command “E8003G7. 


5) Load the MODOS program to be debugged using the MODOS LOAD 
command: 


LOAD program or LOAD programsV 
6) Debug using EXbug. 
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IV. HARDWARE CONFIGURATIONS 


Once the MODOS program has been debugged, the user is 
ready to execute the program in the user’s hardware 
configuration. A typical configuration for MODOS using the 
micromodule !A-D is shown in Appendix A-2. The source for 
the MODOS PROM for this configuration is provided on the 
MODOS diskette. (Reference Section VI.) This software must 
be modified for any other user configuration. 


In order to use MODOS with the final hardware 
configuration, some changes must be made. The disk ROM must 
be generated and placed in the final system. The jump 
vectors to the ROM entry points must be modified. Also, the 
console ACIA and line printer PIA addresses must be changed 
and XBUGFS cleared. In addition to this, the bootblock 
directly accesses the ROM and must be changed. A chain has 
been provided to perform these changes. With the MODOS 
diskette in drive | of an EXORciser/EXORdisk MDOS system, 
enter the following: 


CHAIN OEMCVT81 3 ACIA%XX, XX %, ROMSSYY%,LPS%ZZ%,PIAZNN, WN% 


The parameters XXXX, YY, ZZ, and WNNN are the _ console 
ACIA address, ROM starting address (most significant byte), 
line printer driver starting address (most significant byte), 
and line printer PIA address, respectively. (Reference 
Appendix C for more detail.) Assuming the disk ROM is to be 
used as provided on the diskette, the parameters would be 
entered as follows: 


CHAIN OEMCVT?1 ¢ACIA%E4,08%,ROMSKFCH LPS“ FF%,PIA“EC, 10% 


The chain QEMCVT can only be used if the relative start 
of each entry point in the ROM remains unchanged. If any 
changes are made to the ROM that affect the relative start of 
the routines, the OEM Manufacturer must modify the chain file 
before running it. A commented listing of OEMCVT is provided 
in Appendix C to aid the user. 


In order to reconfigure MODOS to run with EXbug, again 


insert the MODOS diskette in drive 1 of an EXORciser/EXORdisk 
MDOS system and enter? 


CHAIN OEMEX#1 


On completion of the chain, the diskette can be used in an 
EXbug environment only. 


There are a few restrictions as to the type of hardware 
that can be used while running with MODOS,. 


1. A Calcomp drive is required but it can be an EXORdisk II 
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(2 drive, single sided, single density) or EXORdisk III (4 
drive, double sided, single density). 


2. If running MODOS in an EXORciser II system, programs 
cannot be loaded into the user map. 


3. If using a micromodule 1A board, a maximum of 32K of RAM 
is allowed. 


Two hardware configurations that allow MODOS to run with 
a micromodule 1A board are described below. To run MODOS 
using a lA board in an EXORrciser, do the following: 


1. Configure the disk ROM at $CCOO or $FCOO, console ACIA at 
$8408, and line printer PIA at SECIO. 


2. Use the OEMCVI chain file to configure jump vectors 
according to hardware requirements above. 


3. Put ROM on IA board. 
4. Remove debug module and MPU board from EXORciser. 
5. IMPORTANT Jumper KI pins | & 2 and 1 & 3 on IA board. 


6. Set baud rate on IA board the same as_ software is 
configured. 


7. Place 1A board in EXORciser. 
8. Power on sequence will initialize the system. 
WARNING3 With some older versions of the Calcomp 


drives, the data on the diskette may be destroyed if power is 
turned off on the EXORciser while the diskette is in a drive. 


It is possible to configure the MODOS system with the IA 
board in the EXORciser and still have EXbug in the system. 
To do this, perform the following: 


1. Configure disk ROM at $CC90, console ACIA at $8408, and 
line printer PIA at SECIO. 


2. Use the OEMCVT chain file to configure the jump vectors 
according to the hardware requirements above. 


3. Put ROM on IA board. 
4. Keep debug module in EXORciser but remove MPU board. 
5. IMPORTANT: Jumper KI pins | & 3 and 5 & 6. 


6. Two terminals must be interfaced to system--the one _ for 
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EXbug with ACIA at $FCF4 and the other for MODOS at $8408 
interfaced to the IA board. 


7. Set baud rate on IA board the same as_ software is 
configured. 


8. Place 1A board in EXORciser. 
9. Power on sequence will cause EXbug to get control. 
10.Set up interrupt vectors as follows: 
FFF8/0020 
FFFA/0023 
FFFC/0026 
or 


If you want to be able to use MAID to set break points: 
1A8/1 (XBUGFS$=1) 


9. Enter CCO0%G to initialize MODOS. 
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Ve. COMMANDS 


MODOS does not provide all of the commands available on 
MDOS. However, it is functionally compatible with MDOS 3.00 
and the MDOS 3.00 User’s Guide should be consulted for 


details. What follows is a list of commands’ normally 
included with MODOS: 


BACKUP 
COPY 
DEL 
DIR 
FORMAT 
FREE 
LOAD 
MERGE 
NAME 
REPAIR 


The family attribute feature available on MDOS for the 
commands BACKUP, DEL, DIR, and NAME is not available on the 
MODOS version of the commands. 
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VI. NEW ERROR MESSAGES 


During MODOS initialization, the message "ED" may appear 
on the console. This error message indicates that the file 
containing the user’s I/0 routines and/or interrupt vectors 
(MDOSUDRV.SY) is not in a proper format to be loaded. This 
can occur for several reasons? 


1. MDOSUDRV.SY is not a memory image type file. 


2. MDOSUDRV.SY loads below the resident portion of 
MODOS. It should reside at the high end of 
memory so as to allow commands enough memory in 
which to run. 


MODOS does not check that memory exists where 
MDOSUDRV.SY is being loaded. It can be loaded anywhere above 
the command interpreter. This allows MDOSUDRV.SY to be loaded 
as low as $2400 or it may even be loaded into discontiguous 
memory. Qnce MDOSUDRV.SY has been loaded, it cannot be 
overlaid by any commands. MDOSUDRV.SY is not a required file 
and if it does not exist, all of memory is available for 
commands. 


If, during MODOS initialization, the message "WHAT?" 
appears prior to any user input, this indicates that MODOS 
was configured to automatically load and execute a user 
specified file during initialization and the file does not 
exist or is not in memory image format or would overlay 
resident MODOS. (Reference AUTOI$ and AUTOLS$ descriptions. ) 
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VII. DISK PROM 


The disk and line printer controllers must reside in 
ROM. The source for the ROM is included on the MODOS diskette 
in the file ROM.SA. The source has the ROM origined at 
$FCOO, the console ACIA address set at $E408, and the line 
printer PIA set at $ECIO. ROM.LO file is also included on 
the disk and includes the memory image file to be used when 
generating a PROM with the PROM Programmer. The OEM 
Manufacturer may have to modify the ROM in order to remain 
compatible with his hardware configuration. The console ACIA 
address (CNACIS), if different from the initialized value, 
should be changed. The stop bit control byte (SBIT$) may have 
to be changed. The line printer PIA address (LPPIA$) nay have 
to be changed. In addition, two console routines, an output 
character routine and console initialization, ar? also 
included in the PROM. If these are changed, the calling 
sequences must remain compatible with the existing routines. 


To assemble the ROM, insert the MODOS diskette in drive 
l of an EXORciser/EXORdisk MDOS system and enter the 
following: 


RASM ROM#1 3L 


With the ROM residing at $FCOO0, the interrupt vectors 
are set up. The restart vector is initialized so that MODOS 
is automatically loaded and control passed to it whenever a 
restart interrupt occurs. However, the ROM does not have to 
reside at $FCOO. If it does not, it is the OEM 
Manufacturer’s responsibility to initialize the interrupt 
vectors prior to loading MODOS. The interrupt vectors must 
be initialized as follows: 


INTERRUPT VECTOR ADDRESS VALUE 
IRQ FFF8-FFF9 0029 

SWI FFP.A-FFFB 0023 

NMI PFFC=FFFD 0026 

RESTART FFFE-FFFF ** 


**x The RESTART vector should contain the address of the start 
of ROM if MODOS is to be automatically loaded on RESTART. 
Otherwise, control must be passed to the beginning of the ROM 
from another program. 
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APPENDIX A 
MEMORY MAPS 
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$0000 


$001F 
$0020 


$003F 


$2200 


$E800 


$ECO0 
$ECO7 


$F000 


$FFFF 


APPENDIX A 


A MEMORY MAP SHOWING THE MINIMUM 
MEMORY REQUIREMENTS FOR MODOS 
WITH EXBUG 


MODOS DISK PROM VARIABLES 


INTERRUPT VECTORS (PSEUDO) 
MODOS PROM LOAD STACK 


RESIDENT MODOS 


COMMAND AREA 


MDOS DISK PROM 


DISK PIA & SSDA 


EXBUG 
AND CONSOLE ACIA 
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A MEMORY MAP SHOWING THE MINIMUM 
MEMORY REQUIREMENTS FOR MODOS 
WITHOUT EXBUG 


$0000 
$001F MDOS DISK PROM VARIABLES 
$0020 
INTERRUPT VECTORS (PSEUDO) 
$003F MODOS PROM LOAD STACK 
RESIDENT MODOS 
$2200 
COMMAND AREA 
$E408 
CONSOLE ACIA 
$E800 
USER PROM/ROM 
$ECO00 DISK PIA & SSDA 
$ECO7 
eT 
MODOS DISK PROM * 
$FFFF 


*MODOS DISK PROM need not reside at $FCOO. (Reference Section VII). 
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APPENDIX B 
CONSOLE IZ70 ROUTINES 
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PAGE O02 EXSUB .SA%! EXSUB (EXBUG SUBSTITUTE I/O ROUTINES) 


00536 
00537 
00538 
00539 
00540 
00541 
00542 
00543 
00544 
00545 
00546 
00547 
00548 
00549 
00550 
00551 
00552 
0055 3P 
00554 
00555 
00556 
0055.7 
00558 
00559 
00560 
00561 
00562 
00563 
00564 
00565 
00566P 
00567P 
00568P 
00569P 
00570P 
00571P 
00572P 
00573P 
00574P 
00575P 
00576P 
00577 
00578P 
00579P 
00580P 
0058 1P 
00582P 
00583P 
00584P 
0058 5P 
00586P 
00587P 


0000 


0002 
0005 
0008 
OOOA 
O000C 
OOOE 
0010 


OOl2 . 


0014 
0016 
0018 


OOIA 
OOI1C 
001D 
OOIF 
002 1 
0023 
0024 
0025 
0027 
002A 


0000 A 


ad 
>>>>>>r>>>>>rvUvT 


NAM EXSUB 
IDNT  EXBUG SUBSTITUTE 1/0 — OCT. 27, 19 
& 


* CONSOLE I/0 ROUTINES ARE RESIDENT TO 
* ELIMINATE MDOS EXBUG DEPENDENCY 


* 

*PART OF LINE PRINTER -DRIVER FROM THE DISK 

* CONTROLLER ROM IS ALSO INCLUDED HERE. 

* OTHERWISE, THERE WOULD BE INSUFFICIENT ROOM 
* IN THE ROM TO INCORPORATE THE DOUBLE=SIDED, 
* FOUR DRIVE CHANGES. 
* 
* 


XDEF INCHNS, OUTCHS ,PCRLF$ ,PDATAS ,OCHARS, 
TEMPORARY STORAGE FOR X REGISTER (USED IN PLACE 
XSTMP FDB 8) ° 
LIST$ -—— PRINTS CHARACTER AND CHECKS FOR ERROR 


CALLING SEQUENCE: 
A = CHARACTER TO BE PRINTED ON LINE PRINT 
JSR LIST 


ALL REGISTERS ARE PRESERVED UPON EXIT. 
C = O IF NO ERROR. 
C = 1 IF ERROR. 


IST$ EQU * ° 
STX EXSTMP » SAVE INDEX REGISTER 
LDX LPPIAS - PICK UP PIA ADDRESS 
STAA PIADTA,X . SEND DATA 
LDAA #S3E 
STAA PIACTA,X 
LDAA PIADTA,X 


LDAA = #$36 STROBE PRINTER 


STAA PIACTA,X . 
LDAA #$3E ° 
STAA PIACTA,X . 
LIST3 LDAA PIADTB,X .« CHECK STATUS 


*BIT O => SELECT, BIT | => PAPER OUT 
ANDA #3 
DECA - A SHOULD NOT HAVE BEEN O 
BNE ERROR « NE=>NOQ PAPER OR NOT SELE 
TST PIACTA,X .« AKNOWLEDGE ? 
BPL LIST3 « NO 
SKIP! . 

ERROR SEC 
LDAA PIADTA,X 
LDX EXSTMP 
RTS 


RESTORE A REGISTER 
RESTORE X 


eee es 
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PAGE 003 EXSUB 


00589 
00590 
0059 | 
00592 
00593 
00594 
00595 
00596 
00597 
00598 
00599 
00600 
00601 
00602 
00603P 
00604P 
00605P 
00606 
00607P 
00 608P 
00609P 
00610P 
00611P 
00612P 
00613P 


00615P 
0061 6P 
0061 7P 


002B 
002D 
O002F 


0031 
0033 
0035 
0037 
OO3A 
003C 
O03E 


0041 
0042 
0043 


eSA8i EXSUB (EXBUG SUBSTITUTE I/0 ROUTINES) 


* 

*#INTCN$——DOES SOME CONSOLE INITIALIZATION- 
TURNS CONSOLE PRINTER ON 

TURNS PUNCH AND READER OFF 


THIS INITIALIZATION IS IN ADDITION TO 
WHAT IS DONE BY THE DISK PROM 


ALLING SEQUENCES 
JSR INTCN 
ALL REGISTERS DESTROYED ON RETURN 


* 
INTCNS EQU * 
*ACTIVATE TI RDC CARD 


tee ee Ee HH 


BSR DLE$ RDC ATTENTION 
LDAA #73 
BSR XOQCHA 
*TURN ON TI PRINTER 
BSR DLE$ RDC ATTENTION 
LDAA #79 TI PRINTER ON 
BSR XOCHA 
LDX #MSTI PUNCH AND READER ()FF 


BRA PDATAI 
DLES$ LDAA #$10 
XOCHA JMP OCHAR 


MSTI FCB $14 
MST FCB $13 


DC4—PUNCH OFF 
DC3=-READER OFF 


FCB 0,0,0,0,4 NULLS FOR TTY TIMING 
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00619 
00620 
00621 
00622 
00623 
00624 
00625 
00626 
00627 
00628 
00629 
00630P 
00631P 
00632P 
00633P 
00634P 
00635P 
00636P 
00637P 
00638P 
00639P 
00640 
00641P 
0064 2P 
00643P 


0048 
004B 
OO4E 
0050 
0051 

0053 
0055 
0058 
005B 
005D 


OO5F . 


0062 
0064 


eSA%}] EXSUB (EXBUG SUBSTITUTE I/70 ROUTINES) 


* 
*INCHNP--INPUTS ONE CHAR AND REMOVES PARITY 


* 

*CALLING SEQUENCE 

AECHO = O IF CHAR. SHOULD BE ECHOED 
* AECHO .NE. O IF NO ECHO 

* JSR INCHNP 

* A = CHAR. INPUT 
* 
& 
I 


* 


B,X ARE PRESERVED 


NCHN$ EQU * 
STX EXSTMP « SAVE X-REG. 
LDX CNACI$ 

INCH! LDAA ACIACS,X 


BCC INCHI RECEIVE NOT READY 
LDAA ACIADT,X INPUT CHAR. 
LDX EXSTMP RESTORE X 
TST AECHO 
BNE INCH2 DON’T ECHO 
BSR XOQUTCH ECHO CHAR. 
INCH2 EQU * 


CLR AECHO SET ECHO FLAG 
ANDA #S7F REMOVE PARITY 
RTS 
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PAGE 005 EXSUB eSA8! EXSUB (EXBUG SUBSTITUTE I/0 ROUTINES) 


00645 * 

00646 *PDATA--PRINTS CR/LF FOLLOWED BY DATA POINTED 
00647 * TO BY X=REG 

00648 * 

00649 *CALLING SEQUENCE: 

00650 * X = ADDR. OF BUFFER TO PRINT (E0T 

00651 * IN BUFFER TERMINATES) 

00652 * JSR PDATA 

00653 * X AND A ARE ALTERED ON RETURN 

00654 * B IS PRESERVED 

00655 * 

00656 0065 P PDATAS$ EQU * 

00657P 0065 BD OIC6 A JSR PCRLF PRINT CR/LF 

00658P 0068 A6 00 A PDATAI! LDAA X UNDOCUMENTED ENTRY=NO. CR/L 
00659P OOG6A 81 04 A CMPA #E0OT 

00660P O06C 27 06 0074 BEQ PDATA2 STOP ON EOT 

00661P OO6E BD OIC3 A JSR OUTCH QUTPUT CHAR 

00662P 0071 08 INX 

00663P O072 20 F4 0068 BRA PDATAI 

00664P 0074 39 PDATA2 RTS 
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00666 
00667 
00668 
00669 
00670 
00671 
006/72 
00673 
00674 
00675P 
00676P 
00677P 
00678P 
00679P 
0068 0P 


0075 
0075 86 OA 
0077 BD OI1C3 
OO7A 86 OD 
oo7C BD OIC3 
OO7F 4F 
0080 7E OIC3 


eSAl EXSUB (EXBUG SUBSTITUTE I/0 ROUTINES) 


* 
*PCRLF—-OUTPUTS LF, CR, NULL 
* 


*CALLING SEQUENCE 


* JSR PCRLF 
* A ALTERED ON RETURN 
* B,X ARE PRESERVED 
* 
PCRLF$ EQU * 
LDAA #LF PRINT LINE FEED 
JSR OQUTCH 
LDAA #CR PRINT CARRIAGE RET. 
JSR OUTCH 
CLRA PRINT NULL 
XOUTCH JMP OUTCH 
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00682 
00683 
00684 
00685 
00686 
00687 
00688 
00689 
00690 
0069 1P 
0069 2P 
0069 3P 
0069-4P 
00695P 
00696P 
0069 7P 
00698P 
00699P 
00700P 


SA} 


EXSUB 


(EXBUG SUBSTITUTE I/70 ROUTINES) 


* 
*QCHAR—-OUTPUTS CHAR. IN A=REG. 
* 


*CALLING SEQUENCE: 
A = CHAR. TO OUTPUT 


* 


* JSR OCHAR 
* ALL REGISTERS ARE PRESERVED 
* 
OCHAR$ EQU * 
PSHB SAVE B AND X 
STX EXSTMP 
LDX CNACI$ GET ACIA ADDR. 
OCHAR! LDAB ACIACS,X 
BITB #2 
BEQ OCHAR I NOT READY 
STAA ACIADT,X OUTPUT CHAR. 
LDX EXSTMP RESTORE REGS. 
PULB 
RTS 
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00702 
00703 
00704 
00705 
00706 
00707 
00708 
00709 
00710 
OO711 
00712 
00713 
00714 
00715 
00716 
00717 
00718 
00719 
00720P 
00721P 
00722P 
00723P 
00724P 
00725P 
00726P 
00727P 
00728 
00729P 
0073 0P 
00731P 
00732P 
00733P 
00734P 
00735P 
00736P 
00737P 
00738P 
00739P 
00740P 


0097 
OO9A 
009B 
009D 
OO9F 
OOAI 

OO.A4 
OOA6 


OOA9 
OOAA 
OOAC 
OOAD 
OOAE 
OOB |! 
OOB2 
OOB4 
OOB7/ 
OOBA 
OOBC 
OOBD 


0097 P 
o1cc A 


OD A 
15 OOB4 
04 A 
0190 A 
03 OOA9 
O1A7 A 
OOA9 P 


10 OOBC 


oI1cc A 


F5 OOA9 
OlA6 A 
0190 A 
ED OOA9 


eSAt! EXS 


* 


* 


UB (EXBUG SUBSTITUTE I/0 ROUTINES) 


*QUTCH=-OUTPUTS CHAR. IN A=REG. AND PAD CHARS. 


*IF PUNCHING AND CR, PAD 4 NULLS 

*IF PUNCHING AND NOT CR, NO NULLS 

*IF NOT PUNCHING AND CR, PAD CRNL$ NULLS 

*IF NOT PUNCHING AND NOT CR, PAD CHARNS NULLS 
* 


*CALLING SEQUENCE: 
A = CHAR. TO OUTPUT 
CASSET = O IF NOT PUNCHING 


* 


* 
we 
* 
* 
* 
* 
* 


OUTCHS 


QUTCH7 


OUTCHS5 


OUTCH9 


CASSET .NE. 


CRNLS$ 


CHARNS = NO. 


O IF PUNCHING 


= NO. OF NULLS AFTER CARRIAGE. RETURN 


JSR OUTCH 
ALL REGISTERS PRESERVED 


EQU 
JSR 
PSHB 
CMPA 
BNE 
LDAB 
TST 
BNE 
LDAB 
EQU 
DECB 
BMI 
PSHA 
CLRA 
JSR 
PULA 
BRA 
LD.AB 
TST 
BEQ 
PULB 
RTS 


* 
OCHAR 


#CR 
OUTCH5 


OUTCH9 


OCHAR 


OQUTCH7 
CHARNS$ 
CASSET 
OQUTCH7 
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OF NULLS AFTER OTHER CHARS. 


OUTPUT CHAR. 

CARRIAGE RTN? 

NO 

4 NULLS IF CR AND PUNCHIIN 


PUNCHING 
CR AND NOT PUNCHING 


NULL 


NOT CR AND NOT PUNCHING 
PUNCHING AND NOT CR 
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00742 
00743 
00744 
00745 
00746 
00747 
00748 
00749 
00750 
00751 
00752P 
00753P 
00754P 
00755P 
00756P 
00757P 
00758P 
00759P 
00760P 
00761 
00762 
00763 
00764P 
00765P 
00 766P 
00767 
00768 
00769 
00770 
00771 
00772P 
00773P 
00774P 
00 775P 
00776P 
00777P 
00778P 
00779 
00780P 
00781P 
00782P 
00783P 
00784P 
00785P 
00786P 
00787P 
00788P 
00789P 
00790P 
00791P 


OOBE 
OOBF 
00C2 
00C5 
00C6 
00C8 
OOCA 
O0O0CC 
OOCE 


OOCF 
OOD2 
O0OD3 


36 
FF 
FE 
oc 
A6 
85 
27 
8D 
oD 


CE 
32 
39 


oSAt I 


EXSUB 


(EXBUG SUBSTITUTE I/0 ROUTINES) 


* 

*BRKCK--CHECKS FOR BREAK KEY AND CONTROL-W 
* 

*CALLING SEQUENCE 


* JSR BRKCKK 
* CARRY = O IF NO BREAK 
* CARRY = | IF BREAK DETECTED 
* ALL REGISTERS ARE PRESERVED 
* 
OOBE P BRKCKS$ EQU * 
PSHA 
OODO P STX BREAK2+1 . SAVE X 
O1A2 A LDX CNACIS$ GET ACIA ADDR. 
BREAK! CLC 
00 A LDAA ACIACS,X READ STATUS REG. 
10 A BITA #%10000 LOOK FOR FRAMING ERROR BIT 
08 O00D4 BEQ BREAK3 N(Q FRAMING ERROR 
14 OOE2 BSR BREAK6 RESET ACIA FROM FRAMING ER 
SEC 
* 
* THE NEXT INSTRUCTION IS MODIFIED AT ENTRY POINT 
* 
Q0000 A BREAK2 LDX #0 « RESTORE REGS. 
PULA 
RTS 
* 
*NQO FRAMING ERROR=-BUT LOOK FOR CONTROL-W 
* (WAIT) TO PAUSE FOR A WHILE=-wWAIT 
* UNTIL ANOTHER KEY IS PRESSED 
* 
Ol A BREAK3 BITA #1 LOOK FOR RECEIVED DATA REA 
F7 OOCF BEQ BREAK2 NO CHAR. TO READ 
ie} A BREAK4 LDAA ACI ADT,X READ CHAR. 
TF A ANDA #S7F STRIP PARITY 
17 A CMPA #ETB CTL-W? 
F8 OOD8 BEQ BREAK 4 YES, SO WAIT FOR OTHER KEY 
E3 00C5 BRA BREAK I ELSE CHECK FOR FRAMING ERO 
*SESET THE AACIA 
OB OOEF BREAK6 BSR BREAK9 WAIT FOR TRANSMIT READY 
05 OOEB BSR BREAK8 SEND A NULL AND WAIT FOR R 
Ol A LDAA ACIADT,X READ A CHAR. 
Ol A LD AA ACI ADT,X ANOTHER 
RTS 
BREAK8 CLRA 
O1C3 A JSR OQUTCH SEND A NULL 
00 A BREAK9 LDAA ACIACS,X SET STATUS BYTE 
02 A BITA #2 CHECK TRANSIT READY 
FA OOEF BEQ BREAK9 NOT READY 
RTS 
TITLE (SYMBOL TABLE) 


Page B-9 


APPENDIX C 
OEMCVT CHAIN FILE 


“*GOING TO PATCH MODOS FOR NON-EXBUG USER CONFIGURATION 
7*ENTER PARAMETER “ACTIAN%XX,XX\%% WHERE XX,XX IS CONSOLE ACIA 
ADDRESS 


/* EXPRESSED AS TWO BYTES 
7*ENTER PARAMETER “ROMS\%YY\%*% WHERE YY IS MOST SIGN. BYTE 
Jk OF DISK ROM STARTING ADDRESS 


/*ENTER PARAMETER “LPS\%ZZ\%% WHERE ZZ MUST BE THE VALUE “ROM 
S434 

/*ENTER PARAMETER “PIA\% AW, WA\%* WHERE WA, WN IS LINE PRINTER 
PIA ADDRESS 

/* EXPRESSED AS TWO BYTES 

/IFC ACIA 

7*CONSOLE ACIA ADDRESS (ACIA) MUST BE SPECIFIED 

/ ABORT 

/ELSE 

/IFC ROMS 

7*ROM STARTING ADDRESS (ROMS) MUST BE SPECIFIED 

/ ABORT 

/ELSE 

/IFC LPS 

/*LINE PRINTER DRIVER STARTING ADDRESS (LPS) MUST BE SPECIFIE 
D 

/ ABORT 

/ELSE 

/IFC PIA 

/*LINE PRINTER PIA ADDRESS (PIA) MUST BE SPECIFIED 
/ ABORT 

/XIF 

/XIF 

/XIF 

/XIF 

@, INSERT MODOS 3.0 DISKETTE IN DRIVE | 

PATCH MDOS.SY#1 

00 

LA2/ACIAR THESE LOCATIONS ARE DESCRIBED IN SECTION II 
1A8/0 

1 BE/%PIA% 

211/4LPS%,FT7 

214/%ROMS%, 00 

217/ %ROMS %, 39 

21 A/%ROMS%,6A 

21D/%ROMS%, 71 

220/%ROMS% , 80 

223/%ROMS%,84 

226/%ROMS% , 86 

229/ %ROMS%, 89 

22C/%ROMS%,8C 

22F/ “ROMS %, 8F 

232/%ROMS% , 92 

235/ 4ROMS%,95 

238/%ROMS%, 98 

23B/%ROMS%, 9B 

23E/%LPS%,E8 
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DUMP 

Ul 

R17 

4/%ROMS& ,8C/ RESTOR 
T/#LPS%,EB/ LPINIT 
64/6A/ LSB OF CHKERR 

6T/ SR OMS %/ MSB OF CHKERR 
6ASBZROMS% 4847 READPS 

T2/ %ROMS %, 6 AZ CHKERR 
B/CO/ DON’T CHANGE 

W 

Q 

PATCH REPAIR.CM8 | 

22000 

1903/7 %ROMS %, 38C SEE DUMP ABOVE 
19O6/4LPS%,E8 

1963/6A 

1966/%ROMS% 


1969/7 ZROMS %,84 
1971 /%ROMS%,6A 
190A/CO 

Q 

@SET,M 8 

DIR DOSGEN.CM$1 
@TST,T NE,80 
@JMP END 
@SET,M O 

PATCH DOSGEN.CM21 
22000 
5B4/%4ROMS%, 8C 
5B//%LPS %,E8 
O14/76A 

6177 %ROMS% 

61 A/%ZROMS%, 84 
622/%ROMS%,6A 
5BB/CO 

Q 

@LBL END 
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